home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_perl.idb / usr / freeware / catman / p_man / cat3 / File::DosGlob.Z / File::DosGlob
Encoding:
Text File  |  1998-10-28  |  3.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      FFFFiiiilllleeee::::::::DDDDoooossssGGGGlllloooobbbb((((3333)))) 7777////AAAAuuuugggg////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222)))) FFFFiiiilllleeee::::::::DDDDoooossssGGGGlllloooobbbb((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       File::DosGlob    - DOS like globbing and    then some
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           require 5.004;
  13.  
  14.           #    override CORE::glob in current package
  15.           use File::DosGlob    'glob';
  16.  
  17.           #    override CORE::glob in ALL packages (use with extreme caution!)
  18.           use File::DosGlob    'GLOBAL_glob';
  19.  
  20.           @perlfiles = glob     "..\\pe?l/*.p?";
  21.           print <..\\pe?l/*.p?>;
  22.  
  23.           #    from the command line (overrides only in main::)
  24.           >    perl -MFile::DosGlob=glob -e "print <../pe*/*p?>"
  25.  
  26.  
  27.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.       A module that    implements DOS-like globbing with a few
  29.       enhancements.     It is largely compatible with perlglob.exe
  30.       (the M$ setargv.obj version) in all but one respect--it
  31.       understands wildcards    in directory components.
  32.  
  33.       For example, <..\\l*b\\file/*glob.p?>    will work as expected
  34.       (in that it will find    something like
  35.       '..\lib\File/DosGlob.pm' alright).  Note that    all path
  36.       components are case-insensitive, and that backslashes    and
  37.       forward slashes are both accepted, and preserved.  You may
  38.       have to double the backslashes if you    are putting them in
  39.       literally, due to double-quotish parsing of the pattern by
  40.       perl.
  41.  
  42.       Spaces in the    argument delimit distinct patterns, so
  43.       glob('*.exe *.dll') globs all    filenames that end in .exe or
  44.       .dll.     If you    want to    put in literal spaces in the glob
  45.       pattern, you can escape them with either double quotes, or
  46.       backslashes.    e.g. glob('c:/"Program Files"/*/*.dll'), or
  47.       glob('c:/Program\ Files/*/*.dll').  The argument is
  48.       tokenized using Text::ParseWords::parse_line(), so see the
  49.       _T_e_x_t::_P_a_r_s_e_W_o_r_d_s manpage for details of the quoting rules
  50.       used.
  51.  
  52.       Extending it to csh patterns is left as an exercise to the
  53.       reader.
  54.  
  55.      EEEEXXXXPPPPOOOORRRRTTTTSSSS ((((bbbbyyyy rrrreeeeqqqquuuueeeesssstttt oooonnnnllllyyyy))))
  56.       _g_l_o_b()
  57.  
  58.      BBBBUUUUGGGGSSSS
  59.       Should probably be built into    the core, and needs to stop
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 10/23/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      FFFFiiiilllleeee::::::::DDDDoooossssGGGGlllloooobbbb((((3333)))) 7777////AAAAuuuugggg////99998888 ((((ppppeeeerrrrllll 5555....000000005555,,,, ppppaaaattttcccchhhh 00002222)))) FFFFiiiilllleeee::::::::DDDDoooossssGGGGlllloooobbbb((((3333))))
  71.  
  72.  
  73.  
  74.       pandering to DOS habits.  Needs a dose of optimizium too.
  75.  
  76.      AAAAUUUUTTTTHHHHOOOORRRR
  77.       Gurusamy Sarathy <gsar@umich.edu>
  78.  
  79.      HHHHIIIISSSSTTTTOOOORRRRYYYY
  80.       +o   Support for globally overriding _g_l_o_b() (GSAR 3-JUN-98)
  81.  
  82.       +o   Scalar context, independent iterator context fixes (GSAR
  83.           15-SEP-97)
  84.  
  85.       +o   A    few dir-vs-file    optimizations result in    glob
  86.           importation being    10 times faster    than using
  87.           perlglob.exe, and    using perlglob.bat is only twice as
  88.           slow as perlglob.exe (GSAR 28-MAY-97)
  89.  
  90.       +o   Several cleanups prompted    by lack    of compatible
  91.           perlglob.exe under Borland (GSAR 27-MAY-97)
  92.  
  93.       +o   Initial version (GSAR 20-FEB-97)
  94.  
  95.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  96.       perl
  97.  
  98.       perlglob.bat
  99.  
  100.       Text::ParseWords
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 10/23/98)
  130.  
  131.  
  132.  
  133.